Skip to content

Improve Plugin Playground Documentation and Visuals - #151

Merged
krassowski merged 5 commits into
jupyterlab:mainfrom
MUFFANUJ:improveDoc
Apr 9, 2026
Merged

Improve Plugin Playground Documentation and Visuals#151
krassowski merged 5 commits into
jupyterlab:mainfrom
MUFFANUJ:improveDoc

Conversation

@MUFFANUJ

@MUFFANUJ MUFFANUJ commented Apr 8, 2026

Copy link
Copy Markdown
Member

Closes #146

This PR improves the Plugin Playground documentation to make it clearer, more complete, and easier to follow for new and existing users. It refreshes wording where needed and adds in-context screenshots so readers can quickly understand key workflows and verify what they should see in the interface.

@MUFFANUJ MUFFANUJ added the documentation Improvements or additions to documentation label Apr 8, 2026
@github-actions

github-actions Bot commented Apr 8, 2026

Copy link
Copy Markdown
Contributor

Preview environments for this pull request:

Preview Lab Notebook v7
Binder Binder Binder Notebook v7
JupyterLite JupyterLite JupyterLite Notebook v7

@krassowski krassowski left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it is a great, see some minor suggestions. I will ask copilot to scan for typos.

Comment thread docs/images/readme/editor-toolbar-actions.png
Comment thread docs/images/readme/command-argument-docs.png
Comment thread ui-tests/playwright.docs.config.js
Comment thread docs/images/readme/extension-examples.png

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR enhances the Plugin Playground documentation by adding clearer “feature highlight”/workflow guidance and embedding Playwright/Galata-generated screenshots, along with the tooling needed to regenerate them.

Changes:

  • Add a dedicated Playwright/Galata spec to generate README screenshots and store them under docs/images/readme/.
  • Update Playwright configs and npm scripts to exclude screenshot generation from normal UI test runs while enabling an explicit docs:screenshots workflow.
  • Refresh/expand README.md sections (feature highlights, command insert modes, command APIs, advanced settings) and wire README inclusion in docs.

Reviewed changes

Copilot reviewed 8 out of 15 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
ui-tests/tests/readme-screenshots.spec.ts New serial Galata test that drives the UI and saves README screenshots to docs/images/readme.
ui-tests/playwright.docs.config.js New Playwright config that only runs the README screenshot spec.
ui-tests/playwright.config.js Excludes the screenshot spec from default UI test runs.
ui-tests/package.json Adds test:docs-screenshots script.
ui-tests/README.md Documents how to run the screenshot generation script.
package.json Adds docs:screenshots root-level script for regeneration.
README.md Major doc refresh + embeds generated screenshots and updates command/settings documentation.
docs/index.md Adjusts README inclusion options for docs site rendering.
docs/images/readme/*.png Adds generated screenshots referenced by the README.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/index.md
Comment thread README.md

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 9 out of 17 changed files in this pull request and generated 2 comments.


💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread ui-tests/playwright.docs.config.js
Comment thread .github/workflows/build.yml
@krassowski
krassowski merged commit ea3f972 into jupyterlab:main Apr 9, 2026
9 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in CFP '25 tracking Apr 9, 2026
@MUFFANUJ
MUFFANUJ deleted the improveDoc branch April 9, 2026 10:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

Improve Documentation with Screenshots

3 participants